home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / pmnsadd.z / pmnsadd
Encoding:
Text File  |  2002-10-03  |  5.5 KB  |  132 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMNNNNSSSSAAAADDDDDDDD((((1111))))                                                          PPPPMMMMNNNNSSSSAAAADDDDDDDD((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmnnnnssssaaaadddddddd - add new names to the Performance Co-Pilot PMNS
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      $$$$PPPPCCCCPPPP____BBBBIIIINNNNAAAADDDDMMMM____DDDDIIIIRRRR////ppppmmmmnnnnssssaaaadddddddd [----dddd] [----nnnn _n_a_m_e_s_p_a_c_e] _f_i_l_e
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ppppmmmmnnnnssssmmmmeeeerrrrggggeeee(1) performs the same function as ppppmmmmnnnnssssaaaadddddddd and is faster, more
  16.      robust and more flexible. It is therefore recommended that ppppmmmmnnnnssssmmmmeeeerrrrggggeeee(1)
  17.      be used instead.
  18.  
  19.      ppppmmmmnnnnssssaaaadddddddd adds subtree(s) of new names into a Performance Metrics Name
  20.      Space (PMNS), as used by the components of the Performance Co-Pilot
  21.      (PCP).
  22.  
  23.      Normally ppppmmmmnnnnssssaaaadddddddd operates on the default Performance Metrics Namespace
  24.      (PMNS), however if the ----nnnn option is specified an alternative namespace is
  25.      used from the file _n_a_m_e_s_p_a_c_e.
  26.  
  27.      The default PMNS is found in the file $_P_C_P__V_A_R__D_I_R/_p_m_n_s/_r_o_o_t unless the
  28.      environment variable PPPPMMMMNNNNSSSS____DDDDEEEEFFFFAAAAUUUULLLLTTTT is set, in which case the value is
  29.      assumed to be the pathname to the file containing the default PMNS.
  30.  
  31.      The new names are specified in the _f_i_l_e, arguments and conform to the
  32.      syntax for PMNS specifications, see ppppmmmmnnnnssss(4).  There is one PMNS subtree
  33.      in each _f_i_l_e, and the base PMNS pathname to the inserted subtree is
  34.      identified by the first group named in each _f_i_l_e, e.g. if the
  35.      specifications begin
  36.  
  37.                myagent.foo.stuff {
  38.                    mumble     123:45:1
  39.                    fumble     123:45:2
  40.                }
  42.      then the new names will be added into the PMNS at the non-leaf position
  43.      identified by myagent.foo.stuff, and following all other names with the
  44.      prefix myagent.foo.
  45.  
  46.      The new names must be contained within a single subtree of the namespace.
  47.      If disjoint subtrees need to be added, these must be packaged into
  48.      separate files and ppppmmmmnnnnssssaaaadddddddd used on each, one at a time.
  49.  
  50.      All of the files defining the PMNS must be located within the directory
  51.      that contains the root of the PMNS, this would typically be
  52.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ppppmmmmnnnnssss for the default PMNS, and this would typically imply
  53.      running ppppmmmmnnnnssssaaaadddddddd as root.
  54.  
  55.      Provided some initial integrity checks are satisfied, ppppmmmmnnnnssssaaaadddddddd will update
  56.      the PMNS using ppppmmmmnnnnssssmmmmeeeerrrrggggeeee(1) - if this fails for any reason, the original
  57.      namespace remains unchanged.
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. PPPPMMMMNNNNSSSSAAAADDDDDDDD((((1111))))                                                          PPPPMMMMNNNNSSSSAAAADDDDDDDD((((1111))))
  70.  
  71.  
  72.  
  73.      The ----dddd option allows the resultant PMNS to optionally contain duplicate
  74.      PMIDs with different names in the PMNS.  By default this condition is
  75.      considered an error.
  76.  
  77. CCCCAAAAVVVVEEEEAAAATTTT
  78.      Once the writing of the new _n_a_m_e_s_p_a_c_e file has begun, the signals SIGINT,
  79.      SIGHUP and SIGTERM will be ignored to protect the integrity of the new
  80.      files.
  81.  
  82. FFFFIIIILLLLEEEESSSS
  83.      $_P_C_P__V_A_R__D_I_R/_p_m_n_s/_r_o_o_t   the default PMNS, when then environment variable
  84.                               PPPPMMMMNNNNSSSS____DDDDEEEEFFFFAAAAUUUULLLLTTTT is unset
  85.  
  86. PPPPCCCCPPPP EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  87.      Environment variables with the prefix PPPPCCCCPPPP____ are used to parameterize the
  88.      file and directory names used by PCP.  On each installation, the file
  89.      /_e_t_c/_p_c_p._c_o_n_f contains the local values for these variables.  The
  90.      $$$$PPPPCCCCPPPP____CCCCOOOONNNNFFFF variable may be used to specify an alternative configuration
  91.      file, as described in ppppccccpppp....ccccoooonnnnffff(4).
  92.  
  93. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  94.      ppppmmmmnnnnssssccccoooommmmpppp(1), ppppmmmmnnnnssssddddeeeellll(1), ppppmmmmnnnnssssmmmmeeeerrrrggggeeee(1), ppppccccpppp....ccccoooonnnnffff(4), ppppccccpppp....eeeennnnvvvv(4) and
  95.      ppppmmmmnnnnssss(4).
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.